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MCX>ULAR AND PORTABLE DEPLOYMENT OF A RESOURCE ADAPTER IN AN APPUCATION SERVER 





(57) Abstract: A system by which lesouxce ad^>ters 
may be utilhcd in efient server computer configurations 
n tiKrmg enteipiise infbnnation systems is disclosed. A 
coonector provider develops a set of lava interfaces and 
classes as part of its im|4ementatkm of a resomoe a d ap ter: 
These Java implement connector architecture 

specified contracts and implement BIS specific 
fiuictioDafity provided by the resource adapter. The 
development of a resource adapter can also require use 

of native libraries that are ^)ecific to die imdeil]^ EIS. 

The Java inteifoces and classes and native fibraiies, hdp 
files, documcntatioii and other resources (as necessary) 
are then packaged together with a def^oyirmid descriptor 
to create a lesoiBce adapter module. The lesomce adapter 
module defines the contract between a coonector provider 
and deptqyer for the d^loyment of a lesoorce adapter 
in the cliait server environment In order to f aci li ta te the 
con^;QtatioD of the resource adapter in an operational 
environmeDt, the present inventioo ^lecifies the following 
intcriaces and classes. A class that imi^ements a managed 
connection tectovy class supports a set of pnperties that 



factory for the creation of physscal connections to the 
underiying BIS. This implementation class provides 
getter and setter methods for each of its sufported 
properties. The supported properties arc consistent with 
the pcdfication of configor^le properties specified in 
the deployment descriptor: 
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MODULAR AND PORTABLE DEPLOYMENT OF A RESOURCE 
ADAPTER DL AN APPLICATION SERVER 



FIELD 

The pieseat relates broadly to conpHter systems having a clioit servo: 
r/wifignr fttion. Specifically, file presoit invention rdates to resomce ad^teis nsed in client 
server applications. More q;>ecifically sfill, file present invoition relates to a modular and 
5 portable d^loymoit of resomee adqiters in client server q^lications. 

BACKGROUND 

An enterprise information system (EIS) provides an infonnation infirastructure to an 
entoprise in a client-server conqmter system configuration. An BIS offers a set of services 
10 to its clients. These services are exposed to clients as local and/or remote inter&ces. A 
resource manager is a software modnlefiiat manages a set of shared EIS resources. For 
' exanqilei, a transacfional resource manager can parti(^>ate in transactions that are externally 
controlled and coordinated by a transaction manager. 

A resource adapter is a system level software driver provided along wifii an EIS 
IS crmnector and is specific to an underling EIS. A resomce adspter is nsed by aniq^lication 

server or an q^ficatirm cfioxt to cormect to the EIS. The resource aihpter plugs into an 
q^lication servo' and collaborates wifli file qiplication server to provide file undertying 
mediamsms- transactions, security, and connectimi pooling. 

There is currentfyno esdsting standard medianism for d^kr^g and configuring 
20 resource adrqiters in a managed spplication server environment Badi vendor has its own 
qiedfic mechanism, making it difticnltto adneveoff-fiie^dfptngg^ility of resource 
ad^ters in an plication server. For ^plication rfevelopets vAo design and implement 
applicaticm servers, fiie result is an enormous amount of doplicated or neatly duplicated 
effort eaqiended to customize resource adqfiers into a specific client server configuration. 

25 
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SUMMARY 

The present inventioii provides a standardized system by which resource adr^ters 
may be u tiliz ed in client server computer configurations utilizing enterprise information 
systems. A connector provider develops a set of Java inter&ces and classes as part of its 
5 implementation of a resource adapter. These Java classes inqrlanent connector architecture 
qredfied contracts and implement BES specific fimctionalify provided by the resource 
adapter. The develppmeatofaresourceadspter can also require use of native libraries tiiat 
areqiecifictotheunderiyingEIS. The Java into&ces and classes and native libraries, he^ 
file^ documentation and other resources (as necessary) are then packaged tog^er witii a 

10 d^loyment descriptor to rmate a resource adapter module. The resource adqiter module 
defines tiie contract between a coimector provider and deployer fiv tiie dq>loyment of a 
resource adqrter in the client server e n v ironm ent 

In order to fikdlhate the configarafion of file resource adapter in an ppetational 
. enviromneuttiic present invention q>edfies file fiiHowinginterfiices and Masses. Aclass 

15 that moplements a managed connection &chuy class supports a set of properties tiiat provide 
infiumation required hy tire manag ed connection fiictary for the creation of physical 
connections to the underling EIS. This urplementation class {uovides getter and setter 
mefoods for eadi of its sipported properties. The supported properties are consistent witii 
tiie q>edfication of configurable properties q>ecified in tiie deployment desczi^r. 

20 A preferred embodiment of the present invention incoipoiates an env iionm eat using' 

tiie Java Naiiung and Directory Interfiice(JND!0< An application component or client is 
required to look up a connection fectoiy instance in the conponenfs environment usmg tire 
JNDlinterfece. The application component tiien uses tiie connection fectory instance to g^ 
a connection the underiying BIS. Registration of a connection foctory instance in tiie JMDI 

25 name«pace cam he done hy using IWDT Tafewmcft or B crializah le me chanlsma . 

BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 is a high level blodc dii^mm of tiie mqor conponents utilized in a computer 
system according to the luesent inventioo; and 

30 FIG. 2 is a bigii level block diagram ofthe mayor software components utilized in a 

client s^er conputer envircnunent inccnporating an enteprise ixdfotmation system. 
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DETAILED DESCRIPTION 

The presCTit invention specifies requiiements for packaging and dq>loying of a 
resooice adapter. These requiiements stq>poit a modular and portable deployment of a 
resource ad^^ter into a J2QS compliant plication server. 

5 FIG. 1 is a high level block diagram of foe hardware ^ically used in an 

embodiment of foe present invortion. Computor 150 incorporates a processor 152 utilizing 
a central processing unit (CPU) and siqiporting integrated circuitry. Memory 154 may 
include RAM and NVRAM sudi as flafo memory, to fodlitate storage of software modules 
executed by processor 152, such as foe resource ad^ter of foe present invaition. Also 
10 included in compute 150 are k^board 158, pointing device 160, and monitor 162, which 
allow a usK to interact wifo computer 150 during execution of programs. Mass storage 
devices such as di^ drive 164 and CD ROM 166 may also be indnded in conqmter 150 to 
provide storage resource ad^ter and associated files. Conq>uter 150 mqr commimicate 
with other conq>nters via modem 168 and telq>hone line 170 to allow ^pfication serva or 
15 EIS to be operated mnotely, or utilize files stored at different locatimis. Other media may 
also be used in place of modem 168 and telq>hoire line 170, snchasadhectcoimectionor 
high speed data line. The con^nents described above may be operatively connected by a 
cormnunicatiQns bus Wl. 

20 Overview 

A cormectm: provido^ develops a set of Java interfiices/classes as part of its 
implementation ofa resource ad^ter 202. These Java classes implement connector 
architecture specified contracts and inq>lementElS specific ftmctionality provided hyfoe 
resource adapter 202. The development of a resource adapter 202 can also require use of 
25 native libraries that are q>edfic to file underlying BIS 204. The Java inteifoces/classes are 
foen packaged together (wifo tequhed native libraries, heh> files, documentation and other 
resources) wifo a deplcryment descriptor to oreate a Resource Adapter Module 206. A 
dq>loyment descriptor defines foe contract b^weoi a cmmector provider and d^loyer fin: 
foe dqploymoit of atesouice adapter 202. 

30 
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A resource module 206 corresponds to a J2EE module in toms of the J2EB 

composition hierarchy. A J2EE module rq>resents die basic unit of compoation of a J2EB 
qiplication. Examples of J2EE modules include: EJB module, application client module, 
web client module. A resource adapter module 206 can be dqiloyed either directly into an 
5 aqiplication server 208 as a stand alone unit, or with a J2EE application tiiat consists of one 
or more ]2EB modules in addition to a resource ad^ter module 206. The J2EE 
specification specifies requimnents for the assembly and pac fc ag ing of J2EE applications. 
The alone dqiloymoit of a resource adipto module 206 into an a;q>lication server 208 

is typically done to support scenarios in \^ch multiple J2EE applications diare a single 
10 resource adipter module. However in certain scenarios, a resource adrpter module 206 will 
only be required by components within a ^gle JZEB ipplicahoiL The dq>loyment option 
of resource adulter module 206 bundled with a J2EB ^plication sipports die latter 
scenario. During the dqiloymrat, the dqiloy or installs a resource adapter module 206 in an 
application server 208 and then configures it in the target opoational environment 
15 

Packaging 

The file format for a packaged resource ad^ter module 206 defines the contract 
b^we^ a connector provider and deployer. A packaged resource adapter 202 includes Java 
classes andinter&ces diat are required fiir die inplementation of bodi connector contracts 
20 and fimrtirmaia y oftiieTesonrcead^ter 202; ntiKty Java classes fi>T the r es o niceadrpter 
202; native libraries required by die resource adqiter 202; and any he^ files and 
dnc iimentaii on and descxptive meta information diat ties all of the above dements togedier. 
In the preftrred embodiment, aresouice ad^ter 202is bepadcagednmngdie Java ARdiive 
(JAR) finmat into a lesonrce adapter ardiive(RAR.). Fmexanple^aiesomcead^terfin' 

25 EISA can be packaged as an archive with a filename eisA.rar. TheRARfileisstiiictaied 
as a hierarchical directory as follows. /RA-lNEArajcml is a dqiloyment descriptor. /RA- 
INF/cIasses/* is a cfirechny contaming Javaintet&ces, implementation and utility classes as 
reepnted by tile lesomce adulter 202. /RA-INFAiative-Kb/* is a dir ector y confannhig any 
native libraries used by the resource adapter 202. Any platform dependent libraries are in 
30 this directory. 
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The RAR file contains a dqploymait desoiptor based on the format specified in the 
section. The dq>loymeait dcsaiptor is stored with the name RA-INFfiajcml in theRAR file. 
A resource adapter packaged as a RAR file contains a META-INF directory that contains 
information usefiil to flie Java Archive tools. 

5 

D^loyment 

A deployment descaiptor defines the contract between a cormector provider and 
deployer. It c^tures the declarative information that is intended for the dqployer for 
dq>loyment of a resource ad^ter in a target operational environmort A resource adapter 
10 module 206 is deployed based on the dq>loymeot requirements q>ecified by the cormector 
provider through the dq>loyment descriptor. 

Connector Provider’s Responsibility 

The cormector provider qiemfies fire deployment desaq*h)r aresource adapter 

15 ■ 202. The cormector provider specifies general information about a resource ad^tcr, such 
as the name of file resource adapter, a description of file resource adapter, a URI of a U1 
icon for the resource adipter, and the identity of the vendor vdio provides file resource 
aihpter. The connector provider can also spedty the type ofEIS system, sn^ as the name 
of a qiecific database!, ERP system, etc. Additionally, file connector provider can apedfy fire 
20 version ofthecounect(nq;>ecificatiQn (represented as a string) supported by file resomce 
{wta ptET, as well as file veinon of file resource adapter, also rqnesented as a string. 

The connector provido^ also specifies the fiilly q[ualifiedname of file Java class fiiat 
nn p l emerrts file javaxjesourceldanagedConnectionFactoiy inter&ce, as well as the fiilty 
qualified name of fiie Java inter&ce and implementation class for file connection fiictoiy . 

25 The connector provider qiecifies file fiilty qualified name offiie Java interfoce and 

inplementation class for file connection interfoce. The connector provider specifies the 
levdoftransaction support provided by the resource adapter inDplmnentafion. Thelevdof 
transactimi s upp ort can be any one of fiie following: nojtraiisaction, localjtiaiisaction or 
xajinmsaction. Note that this support is qiedfiedfinr a lesonrcead^ter and not fiir file 
30 ondatying EIS instance, nojbansaction indicates fiiat fiie resonice adaptor 202 does not 
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siq>poit either resource manager local or JTA transactions. It does not implement either 
XAResource or LocalTransaction interlaces. 

localjransaction indicates that ttie resource adapter 202 supports resource m a n a g er 
local transactions by implementing the LocalTransaction intCTfece. 

5 xa transaction indicates that die resource ad^ter 202 supports both resource 

manager local and jPA transactions by inqilementing the LocalTransaction and 
XAResource intefeccs respectively. 

The connector provider specifies name^ type, description and an optional default 
value for the properties that have to be configured on a per ManagedCJonnectionFactoty 
10 instance. EadiManagedCoimcctionFactory instance weates connections to a ^lecific BIS 
Irxrfarx-A based ou the p r op e r ties configured on the ManagedConnectionFactoty instance. 
The crmfiguiable {uoperties are spedfied oofy once in the deployment desoiptor, even 
diou^ a resource adq[>ta 202 can be used to configare multiple 

ManagedCanunectionFactoiy instances (that create connections to (fifferent instances of die 
IS sameEI^ For example, a d^loyment tool can create multqile copies of XML based 
dqiloymoit desci^tor; eadh copy of the dq»loyment descriptor carries a specific 
configuration of p ro p erties ftr a ManagedCoonecfionFactory. 

Authentication Mechanism 

20 The connector provider ^ecifies all the andientication medianisms that are 

siqipoited by die resource adapter 202. This relates to die sqq;>Qit provided by die resource 
adapter 202 implemmtation but not by dw unde^ing BIS instance. The standard values 
aietbasiqpasswordandkeriivS. The resource ad^ter 202 can support one or more of diese 
me rhaniang. Basiqiasswordis auserpasswordbasedaudientication 
25 fuftchaniian that ta specific to an BIS Keriiv5 is a Kerberos veratm 5 based anflienticaticai 
mechanisirL Iftiiere is no antiioiticationniedianism spedfied as part of die deplrqunent 
descriptor, the resource ad^ter 202 does not support any standard security a nd i e n ti ca ti on 
mechanisms as part of secmity contract 

The connector provider ^>ecifies wbedier resource adapts 202 supports 
30 reautiientication of an existmg physical cmxnectiorL The security permisdon listed in tiie 
dqiloymentdess^torare different fimn those required by die de&nlt permission set The 
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dq>loyment descriptor q>eci£led by the connector provider for hs resource adi^ter is 
consistent •vvidi the XML document type desoiption (DTD) as specified below. 

Dqiloyer Reqx>nsibilities 

5 The dq>loy w is responsible for using a dqiloyment tool to configure a resource 

adapter 202 in a target operational oivironment The configuration of a resource adapto' 202 
is based on toe properties defined in the d^loyment descriptor as part of toe resource 
adapto^ module 206. The deployer pertonns toe following tarics to configure a resource 
adpt^202. 

10 The dqployer configures one or more prcperty s^ (per ManagedCormectionFactory 

instance) for Creating connections to various underlying EIS instances. The deployo: 
oeates a p roperty set by using a d^loyment tool to set valid values &r various ccmfigmable 
fields. The configuratian of each field is based on toe name, type and desoption of toe 
fidd pedfied in toe dq>loyment desorptor. 

15 Each property set rpresents a pacific confignration tor creating connections to a 

pedfic EIS instance. Since a resource adpter 202 can he used to create cormections to 
multple instances of the same EIS, there can be mnltiple property sets (one tor eadh 
configured instance of the object ManagedCormectionFactory) tor a single resoorce adpter 
202 . 

20 The dployer also configures pplication server 208 mechanisms tor transaction 

management based on the level of transaction suport pecified by toe lesouice adpter 202. 
Additionally, toe dployer configures security in tile target eperationalemv iroum ent based 
on toe security recpiiremaits pedfiedby the resource adpter 202 in its dployment 
descrptor. During dploymoiL the dployer can dieckwhetoer or not an undalying EES 

25 instance sppoits toe same cpabilities sncto as transaction sopoit and antirentic^tion 

medianisms as tile cotrepondiiigiesoiiice adpter 202. For example^ ifa resource adapter 
202 provides inplementation sipport for Keriieros based aotoentication but the underlying 
EES instance does not spport Kjeibetos, then toe dployer can dedde not to configure 
Koberos tor authentication to this EIS instance. However iftiie dployer does not pertoim 

30 sudi diecks durh^ dployment, any misconfigarations should lead to runtime excptions. 
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Application Server Responsibilities 

An implication sCTver 208 provides a dq>loyment tool fliat supports dq>loyment of 
multiple resource ad^ters. A deployment tool can also be provided by third party 
enterprise tools vendors. A dqiloyment tool is capable of reading ttie deployment 
5 descriptor from a resource ad^ter module 206. It enables the dqiloyer to configure a 
resource a<lapter 202 in the operational environment and ther^y reflect flie values of all 
propoties declared in the deployment descriptor for flie resource adapter 202. A 
dqiloyment tool supports inanagement of multiple property sets (one per configured 
ManagedConnectionFactory instance) for a resource ad^ter 202. This includes support for 
10 adding m removing a property set from die configuration for a resource adipter 202. 

A d^loyment tool supports addition and removal of resource ad^ters fiom an 
operational environmenL An qiplicafirm server 208 uses the dqiloyment properties about 
the cqiabifitiesofa resource ad^ter 202 (frirexanmle* siqipott level frnr transactions) to 
provide different QoS for a configured resource adqiter 202 and its underlying EIS. The 
15 prefrrredembodimait of the present invention incorporates flie following interfoces and 
classes. 

ManagedCormectionFactory 

The class fliat inqilements ManagedConnectionFactt»y 212 interfrice supports a set 
20 ofproperties fliat provide infbrmatiQn required by the ManagedConnectiaiifiKrtQry 212 for 
fliecreatianofphysical connections to flieundertyingEIS. A resource adrpter 202 can 
implemoit the ManagedCormectionFactory 212 interfrice as a Java Bean. AsaJavaBean 
irrqilementor, the resource adapter 202 can also provide aBeanhifo class that implements 
flie java.beaiisJBeanlDfo interfoce and provides eaqilidt infrimiation about flie methods and 
25 properties supported by the ManagedOnmectionFactory implementation class. The 

inq>kmeiitati(m of ManagedConnecfloiiFactoiy 212 as a JavaBean mproves the tool abilrty 
(for tools fliat are based on the JavaBeans fiameworlc) frir the configDration of 
ManagedCoimectioiiFactoty instances, hi flie preferred embodiment; the dqiloyment tool 
uses an XML based deployment descriptor to find out the set of configurable prop er ti es for 
30 aManagedCoimectioriFactory212. A dqiloymoitdescr^tor for a resource adapter 202 
specifies name, type, desca^tion and defeult value of flie configaiable pnperfles. 
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Properties Conventions 

The ManagedConnectionFacstoiy inqilementation class provides gette and setter 
methods for each of its si^ported properties. The supported properties are conastent with 
the q>edfication of configurable properties ^>ecified in the dq>loyment desoiptor. The 

5 getter and settCT methods convention are based on Java Beans design pattem. These 

methods are defined on the implemoitation class and not on file 
ManagedConnectionFactoTy interfiice 212. The reason for this requirement is to keep 
ManagedConnectionfectory interfece 212 indqiendent of any resource adapter or BIS 
q>edfic properties. 



Standard Properties 

The connector ardiitecture identifies a standard set of propCTties common across 



15 



20 



various types of resource adsqitcrs and EISs. A resource adapter 202 is not requiied to 

sB 5 >port a stmidaid property if that property does not apply to its configuration. These 

standard properties include the name of tile 8«ver fiw file BIS instance, the port number fiir 

establishing connection to an BIS instance, name of file user estabHshirig connection to an 
EIS password fi>r file user establiahing connection, and file URL for flie BIS 

instance to 'which to connect. 



Tfi addition to these staiidaid propextiesy a ManagedConnectionFactoiy 
inq>lementation class can supp ort p roperties diat are q>ecific to a resource ad^ter and its 
undexfyingEIS. AH file properties arc administered by the deployer and are not irisible to an 



supplication componoit provider. Hisi 
spedfic iwnftg or be restricted to weH defined values, hi the XML d^Ioyment descriptor, 
any bounds or well defined values of properties are described in file description dement 



25 

XNDI Configaration and Lookup 

hi both TniiiiagfMl apH TMwmmnage d application scenarios, an application componCTt 
210 (or application client) looks rq> a connection fectoiy iiistaiiccin file, conqwoent’s 
environment using flie Javablainiiig and Directory hiter&ce (JNDI). The appheahon 
30 component 210 then uses the connectianfectory instance to get a connection to file 

nnderiying BIS. The fbHowing code extract exanqple shows flie JNDI lookup of a 
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javaxjesouice.ccLCoimectioiiFactoiy instance. 

// Application Component/Client Code 
obtain the initial JNDI context 
Context initctx = new InitialContextO; 

5 // perfonn INDI lookq> to obtain connection fectoiy 

javaxjesouice.ccLConnectionFactoiy cxf = 

Qavaxjesource.cd.ConnectionFactory)initctx.loolcDpn’ava:comp/ 

eny/eis/MyEIS”)j 

javaxjresource.cci.Connection cx = cxtgetConnectionO; 

10 In managM l nr n^fimsmag ed environment registration of a connection factory 

214 instance in die JNDI namespace can be pofonned by using eidier JNDI Reference or 
mMdiani5an. The dioice b^ecn the two JNDI mec h a ni s m s dqiqids on 
whetho^ the JNDI jmivider bdng used siqipoits qpedfic medianism, whedKr flie ^iplicahon 
sava 208 and resource adapter 202 provide die necessary si:;>poit as q>edfied in die 

15 reqiective requirements, and any constraints on die size ofseiialized objects diat can be 

stored in die JNDI name^ace. The reftKnce mechanism allows for only a refcienco to the 
actual object to be stored in the JNDI namespace. This is preferable to die sedalizable 
m f*^hanigin that stmes die whole serialized object indie namespace. 

20 Dqiloyer 

The d^loyer is req;Kmsible fi>r configuring oonnectioa fectoiy instances in die JNDI 
environment Tt*«^<t«T»l»yer manage stfieJNDT fiarmeqiace sudi diat die same programming 
model for JNDI based connection fectory lookup is supported in both managed and 
nonmanaged eondronmeats. 

25 

Resource Adapter 

The ttn pi fti iifint a Hft n r.lafi« for a connection fectory inteifece is required to hxqilemeat 
the java. ioJSeriatizriile interfece to s uppoit JNDI r^jstradon. An inqplementadon of 
javaxjiaining. Referenceable interfece by connection fectory class is only requited if the 
30 connection fectory 214 supports Referancemechanismrbased JNDI r^stradoiL The 

Hnpl emftnfati nin olaga ia requited tO inclement the 
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java.io.Serializable mtoface. To support Reference mechanism in a nonmanaged 
fpvi mnTn ent, a lesouTce adapict or a helper class is utilized to provide an uuplementatioii of 
the javax.naming.spi.ObjectPactory interface. 



5 y^lication Server 

The implcanesitation class for javax jesouice.ConnectionManagCT is reqnired to 
implement java.io.Sorializable interface. If an application servor 208 siqjports JNDI 
Reference mechanism based connection fectoiy looki^, it is required to provide an 
in^lemoitation class for javax, naming. q>i.ObjectFactory inteiface. The m^leiuentalion of 
10 this intcifece is plication server specific. 

In a serializeable scenario^ The implementatioii classes for bofli javaxjesonrce.- 
cd.ConnectionFactoiy and javaxjesourceJManagedConnectiooFactoiy intofoces 
iiBplCTient java.io.S«iaIizrf)le interfece. The deployment code rrfrieves foe configuration 
propoties fiom the XML d^loyment desraiptor for file resource adapiei 202. The 
15 dqiloyment code fiien creates an instance of ManagedConnectionFactoryiiiqilementation 
class and configures pnperties on file instance. An example qipears below: 

// Dqiloyment Code 

// Create an instance of ManagedConnectianFactory inq>lemeatalion class 
cornjnydsJdanagedConnectionFactoiyfoDplincf— 

20 new eximjiQneisAfanagedCQiinecfionFactmyiinplO; 

// Set properties emManagedConnectioDFactoiy instance 
// Note: Properties are defined on file inqilonentation class and not on the 
// javaxresource.ManagedCoiinectioiiFactoTy interfoce 
mefsetServerNamef*...”); 

25 mc£sefPortNambei(“...”); 

Tti a onry -manage it faiy mwnnent^ an :qiplicalion developer writes file dqiloymeat 
code. Whilein anaanaged euvironmenL file dqiloymentcode is typically hidden by a 
deployment tooL The deployment code uses the ManagedConnectioiiPactory instance to 
30 create a cormecdon foctory instance. The code then registers file connection fiictoiy 
instance in file JNDI namespace.^/ D^loymmt Code 
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// fil managed environment, oreate a ConnectioDManaga’ specific to 
// file ^plication server. Note that in a nonmanaged environment, 

// ConnectionManager is specific to the resource adq>ter. 
com.wombatservCT.ConnecdonManager cm = 

5 new com-wombats«ver.ConnectionManaga:(...); 

// Create an instance of connection f^oiy 
Object cxf = mc£createConnectionFactoiy(<an); 

// Get 3NDI context 

javax maming.Context ctx ~ new javax.namhig.TnitialContext(qiv); 

10 // Bind to toe JNDI nameqjace specifying a &ctoiy name 

ctx.bind("...", cxf); 

When an rqjpiication component 210 does a JNDI lookiq) of connection fiictoiy 
instance, the retained connection fiictoiy instance is assomated wifii a configured 
ManagedConnectionFactoiy instance and a ConnectiohMan^^ instance. The 
15 inq>lementation class for connection &ctoiy 214 adneves the assodationb^ween these 
iTiirfancea in an implementation q>ecific manner. A JNDI configuration in a managed 
environment can be based on toe Reference mechanism, using toe Cd intertoces 
javaxjesouice.ccLConnectiohFactGiy and javaxjesouice.ccLCoDnecti(m as connection 
&ctoiy214 and connection inteitoce,ieq>ectiv^. 

20 

Scenano: Refoenceable 

The iirplemeatation class for ConoecfionFactoiy intecfiice 214 ingilements toe 
javaxmaming. Referenceable as toown in the following code mdxact exanq>le, 
public class com.myds.ConnectionFactoiyfiiqpl implements 
25 JavaxmamingReforenceable, 
javaio.Soializable, 
javaxjesource.ccLConnectiohFactoty { 

// Refoence to this ConnectimiFactoiy 
JavaxjiamingRefemnce leforenc^ 

30 //setRefermice is called by dq)loymmit code 
prtolic void sefReference(Refeience ref) { 
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refeence = ref, 

} 

// getReference is called by JNDI provider during ContexLbind 
public Reference getRefOTenceQ Arrows NamingException { 

5 return refeence; 

} 

) 

Note that the me^od setRefeence is not defined as part of tibe Refeenceable intofece. 
LO An plication servo: 208 provides a class (in an plication server qredfic 



15 



20 



ObjectFactoiy.getObject-Instance method, the information carried by the Reference 
parameter (as set in Aie Connectioii-FactoryliiqrLse^feraice method) is used to lookiq) file 
property set to be configure on die target ManagedCormeclicmFactory instance. The 
TTm ppmg from a Refisrence instance to multiple configured propoty sets enables an 
plication servCT 208 to configure multiple ManagedConnectioiiFactory instances with 
respective propoty sets. An i^lication server 208 m ai nt a in s the property set configuration 



in an implemoitation specific way based on Are dq;>loyment desoiptor spedfication. 

The implementation and structure of Reference is q»edfic to an {plication server 
208. The following code extract shows an illustrative example of Are 
ObjectFactoiy.getObjectlnstance mediod. 

ptfolic class com-wombatservar-ApplicationServerJNDIElandler 
wn plement s javax.nainmp.spLObiectPactorv { 



//... 

25 public Object getObjectfastance(Object obj. Name name. Context ctx, Hasbtable env) 

fiuows Bxcq>tion { 

jav ar namtng .Reference ref = (javax.namingReftrence)obj; 

// Using die information carried by die Reference instance, 

// (<referenceName> logicaIName> in Abis example) lookqi 
30 // a configured property set and Aien configure a 

// ManagedConnectionFactory instance wiAi qiecified 
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//properties. 

// ... [implanentation specific) 

// 

// For example: the instantiation of ManagedConnectionFactory 
5 // implementation class and invocation of its sctto m^od 

// can be done using Java Reflection me ch a nism . 
javaxjesourceJManagedConnectionFactory mcf = II... 

H CTeate a Connection Manager instance specific to the 
// Explication server 

10 conLWombatserver.ConnectionManagercxManager=// ... 

// create a connection bsAoiy instance. 

• // The ConnectionMaiiagCT instance provided by the plication 
// searver gets assodated with tiie created 
// connection &ctory instance 
15 return mc£cTeateConnectionFactory(cxManager); 

> 

> 

Ihe follondng dqrloyment code example drows registration of a reference to a 
20 connection &ctoiy instance in the JNDInameqpace:y/Dq>loyment Code 
javaxmaming.Coiitext ctx - new javaxnaming.TiritialContext(aiv); 

// Qeate an instance of connection fiictory 
corrunyeis-ConnectionFactoiylmpl cf = 
new conunyeis.CainiectionFactoiyInx>10; 

25 //Create a reference fi>r the ConnectionFactoiy instance 

j^v OT nnmfng -Reference ref = new javaxjiamingJRefefencef 

CdtmectionFactotylDq>l.class.getNameO> 

new javaxJ)aming.StringiR^C^ddi( . 

“<referraiceName>”, “<logicaINam^”), 

30 ApplicationServerJNDIHandler.class.getNameO, 
null); 
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cf.setRefeiencc(ref); 

// bind to the JNDI name^acc specifying a name for the connection fectoty 
ctx.bind("...", cQ; 

The dq)loymrait code is designed as geaenc. The code dynamically oreates an 
5 instance of connection fectory 214, create a Refeence instance and then set the lefemice. In 

the above code sanq>le, the s^efemice method is implementation specific and is not 
defined as part of toe Refemiceable intertoce. The ContexLbind method registos a 
Refeaence to toe coimection fiictoiy instance in toe INDI namespace. 

10 Connection Factory Lookrqr 

The fbllo'wing steps h^rpen ■when an ^rplicatron coiirponent 210 calls toe metood 
JNDI Con t*^ lookiq) to lookiqt a connection fectory instance. First, toe JNDI passes 
control to toe application sraver 208 and ^ metood ObjectFactory. getCtojecOnstance 
inq)lanented by toe supplication servo: 208 is called. The application server 208 toen 
15 creates a new instance of ManagedCarmectioiiFactoiy implemoitation class provided by toe 
resource ad^ter 202. The sqrplication sover 208 then calls setter metoods on toe 
ManagedConnectiQnFactoiy instance to set various configuration properties on this 
■ instance. These properties provide information that is required by the 
ManagedCoimectionFactoiy instance to create physical connections to toe underiying £1S. 
20 The application server 208 uses an existing property set (configured during the dqiloyment 
of resource adi^ter) to s^ toe required pn^>eities on toe ManagedCoimectionFactoiy 
instance. 

After toe newly created ManagedConnectionF actory instance has been configured 

0 

Tvito its property set, toe a]q>lication server 208 creates a new ConnectionManager instance. 
25 The qq>lication server 208 tool calls fire metood createConnectionFactoiy on toe 

MimagpHrnTme ctionF actory instance tyasnng in toe ConnectionMariager instance finm toe 
previous step) to get a ConnectionFactoiy instance. 

The qrplication server 208 ftiea returns ftie coimection toctoiy instance to toe JNDI 
provider so ftiat this instance can be returned as result of ftie JNDI lookiq). The rqqpUcatioii 
30 cmnponent 210 g^ftieConnectionFactoiymstaiice as a result oftoe JNDI lookiq). 
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The extensible Maikq) Language PCML) Documient Type Definition 0>TD) may be 
used for the dq>loymen.t des(^tor for resource adapter 202. The conomeuts in die DTD 
specify additional requirements for the syntax and sonantics that cannot be ^ecified by the 
DTD mechanism. All valid resource adapto' deployment descriptors contain the following 
5 DCKTIYPE declaration: 

<!DOCTYPE connector PUBLIC “//Sun Microsystems, Inc7/DTD Connector 1.0/ 

/EN” ‘1itq):/^ava.snn.copi/j2ee/dtds/connector_l_0.dtd”> 

The root element of the dqiloyment desci^tor for a resource adq>ter is foe 
connector. The content of foe XML elements is usually case soisitive. A resource adrq)ter 
10 (ot an application savor on bdialf of resource adrq>ta 202) can q>edfy additional 
dq>loyment information beyond foe standard deployment desoiptor. Die additional 
information is stored in a separate file and refem to foe standard dqiloyment descr^tor. 
Resource adapter 202 is not allowed to add aoy nonstandard information into a standard 
dqiloymoxt descriptor. 

15 The connector elemoit is foe root dement of foe dqiloymait desoiptor fin foe 

coimector. Dus element includes general infiumatiori venttorname^ versian, specification 
version sipported, and icon related to foe resource adapter module 206. It also includes 
infiumatirm pedfic to foe inplementation of foe resource adapter library as q>ecified 
through foe element lesourceadapter, as shown in foe following illustrative example. 

20 > 

<!ELEMENT cormector (di^l^name; description?, icon?, vendomame, speeversion, 
dstype, version, resourceadapter)> 

<1 

The element resourceadaptex specifies rnfimnation about the resource adapter 202 
25 provided by foe coimector {oovider. The infimnation includes fiiHy qualified names of 
classfinterfices required as part offoe cormector architecture qiedfied contracts; levd of 
transaction sipport provided, configarable properties for ManagedConnedioDFactoty 
instance, one or more aufoentication mechanisms srqpcuted and addifional required secuiify 
petmissioas. Iffoere is no aufoentication medianismqiedfied as part of resource adapter 
30 ftlement foe resource adapter 7.(Y2 does not jmpport any .rtandard aiifofintieatio n mp rlutnisima 

as part of security contract An exanple of foe resourceadipter dement appears below. 

> 

<!ELEMENT resourcead^ter (managedconnectionfectoryclass, coimectionfectoryintexfece, 
connectioniactoryinpldass, connectioninterfoce, coimectioniiipl 
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transactioiisappoit, configiropaty*, autbmecliaiusm*, reaulbentication 
siq>poit, securitypennisdon* 

> 

<! 

5 The aiitliTnfirihnnism specifies an aufhaiticalion mechanism si^^ported by 

Qie resource adsq[>ter 202. Note fiiat fins support is for file resource adq>ter202 andnot for 
the undeiiyiiig BIS instance. The opfional deso^fion specifies anyresource adaptm* qiedfic 
requirement fi>r file siqipoit of security contract and authmtication mechanism. An example 
of the autbmechanism element qipears below. 

10 > 

<!EL£MENT anthm i ^lianigni (description?, aufiunechtype, credcatialinterfi>cef)> 

<! 

The elemait credeafialmterfoce ^ecifies the interface that the resource adapter 
inoplmieatationstpports for file representation offiie security credentials. Thiselementis 
1 5 used by qiplication server 208 to find out file Qedential inter&ce it ^uld use as part of file 
security contract The possible values are; 

<aedentiaImter&cd>javaxjesoazce.secaTityJPasswardCredentiaI 

</credentia]interfoce> 

<ciedentialinterfiice>3avaxjesonrce.secority.GenaicQcdential 
20 </cxedentia]intecfoce> 

> 

<!ELEMENT cxedentialintec&ce (#PCDATA)> 

<1 

The elqnent authmechtype spedfies type of an authentication medianiam. The 
25 possible values are: 

<authmechtype>basicpassword<?anfiuiiedi^pe> 

% 

<salhmechtype>keibv5</ authmeditype> 

> 

<1ELEMENT anfimieditype (#PCDATA)> 

30 <! 
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The elonait coQnecdan&ctotymtei&ce ^>ecifies tfie ioHy qualified name of the 
ConnecfionFactotyinto&ce supported by the resource ad^ter 202. An exanq>le sqrpeais 
below, 

<eonnection&ctoiyintafac^avaxjesouice.ccLConnectionFactoty 
5 </coimectionfectoryintcxfice> 

> 

<!ELEMEOT connectionfiictoiyintrafece (#PCI)ATA)> 

<! 

The elonent connection&ctoiymqrlclass q>ecifies the fully qualified name of the 
10 ConnectionFactoiy class diat implements resource adapta ^>edfic CormectionFactory 
interfece. 

Bxanq>le:<cormection&ctotymplclasS>c(MiLwombatCQnnectionFactory£aq>I 

<7cormection&ctoryinq)lcla8s> 

> 

IS <!ELEMENT connectioii&ctoryiioplclass (#PCDATA)> 

<! 

The element coimectioninleiface q>edfies the fully qualified name of the 
Connection inteifiice siqrpQcted by fire resource adapter 202. 

Exan^le: <%ormecfionmtei&ceP>javaxjesonrce.cd.Coimection 
20 </coimectionmtei£ice> 

>,<IELEMENT connectiaDinter&ce (#PCDATA)> 

<I 

The element connecti<mmq>lclass specifies die fiilty qualified of fiie 

Connection class drat implements resource ad^ter <pe cifie Coonectimi 

25 Example: <oonnectioiiiiiq>lclas^>copL wombat Cc wme cHf wiTmp I 
</connectioDhiq>lclasS> 

> 

<!ELBMENT cormecdonimplclass (#PCDATA)> 

<! 
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The element configmtiy contains a declaration of a sin^e configuration piopoty for 
a ManagedConnectionFacttHy instance. Each ManagedConnectionFactoiy instance creates 
connections to a specific EIS instance based on the properties configured on the 
ManagedConnectionFactory instance. The configurable properties are spedfied only once 
5 in the dq)loymrat descriptor, even though a resource adapter 202 can be used to configure 
multiple ManagedConnectionFactory instances (that oeate connections to dififerent 
instances of the same EIS). The declaration consists of an optional description, name, type 
and an optional value of tiie configuration property. If the coimector provider does not 
spedty a value than the dqiloyer is req>onsible fi>r providing a valid value for a 
10 configuration property. Any bounds or well defined values of properties are described in 
the desoiption donent An example sq>pears below. 

> 

<!ELEMENT configproperty (description?, confiamapertyname, coofignopaty 
type, configprppertyvaIue7)> 

15 <! 

The element confi^ropertyname contains the name of a configuration pro p erty. 

Example: <confi^ropertyname>ServerName</confi^ropertyiiam^ 

The connector architecture defines a set of well defined pr o p erties all of type 
java.lang.String. These are as follows in the exanq>les: 

20 <^nfig)ropertyname>ServerName<?confiajrapertyname> 
<configprope3tyname>PortNumber<?config)ropeityname> 
<coiifigprt^)eityi)am^>Usert^aQie</coDfigpr(^ertynaiD^ 
<config)Kyettyname>Password</c<mfig >rop er ty namtf> 
<confia)ropertyname>ConnectionURL</configpropertyname> 

25 The connector provider can extend this property set to include properties specific to a 

resource adapter 202 audits undertying EIS. 

> 

<!ELEMENT configpropertyname (#PCDATA)> 

<1 

30 The element configpiopertytype contains the faOy qualifies Java type of a ' 

configuration property as required by ManagedConnectionFactoiy instance. Theforiowmg 
are tire legal values of config piop ert y type: java.lang.BooIeaD, java.lang.String, 
javaJang.hit^er,.javaJangJ)oid>Ie, java.laagJSyte^ j8va.]ang.Shoi^ javaJangXong, 
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java.langJloat 

Example: <configpropertytyp^ava.Iang.String</configproperQ/typ^ 

> 

<!BLEMENT configpiopextytype (#PCDATA)> 

5 <! 

The element confi^iopertyvahie contains the value of a configuration entry. 
Exaiiqrle: <configpropa1yvalu^WoinbatS«ver</confia>ropeityvalue> 

> 

<!ELEMENT configpropcrtyvalue (#PCDATA^ 

10 <l 

The element di^layname contains a short name tor the connector fiiat is intended 
to be di^layed by the tools. 

> 

<!ELEMENT diqrlayname (#PCDATA)> 

15 <! 

The elemoit description is used by connector provider to provide text desoibing the 
paorent elemort The descr^tion element includes any infinmatioa that the connector 
provider wants to provide to fire dqrloyer. Topically tools used by tire ctmsnmo' of resource 
adapter ittisdule 206 will display fire description when processing the parent element 

20 > 

<!ELEMENT descriptron (#PCI>ATA)> 

<! 

The element eastype contains infirrmatioii about fire type of fire EIS. For eyamplft, 
fire type of an EES can be product name of EIS independout of any yernon info. This he]^ 
25 in idenfi^ng EIS irrstaircesfiiat can be nsedwifirfiiisresonrce adapter. 

> 

<!BLBNffihrr dstype (#PCDATA)> 

<I 

The icon element contairrs fire narrre of a file corrtaintng an icon image firr fire 
30 'resource ad^ter module 206. The file rranre is relative pafii within fire resource ad^rter 
module 206. This file is be eifirer in JPEG or GIF fbnnat. The icon is used by tools to 
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di^lay information about tiie lesoo^ adq>tCT module 206. 
Example; 

<icoii>lib^agesAvombatadaptCT.jpg<^con> 



> 



5 <!ELEMENTicon(#PCDATA)> 

<! 

The elemeat managedconnectionfectoryclass specifies Hxe fiiUy qualified name of 
flie Java class that implements the javax jesource.ManagedConnectionFactoiy inter&ce. 
This Java is provided as part of resource ad^ter*s inq>lementation of connector 

10 specified contracts. 



Exanq>le: 

<managedconnectionfactorycIass>com.woinbatManagedConnectionFactoiyImpL<;/'manage 

dconnection&ctoiyclass> 



> 

15 <!BLBMENT managedconnectionfectoryclass (#PCDATA)> 

<! 

The ftlwrpep* reantiienticationsupport q>ecafies wheOrer the resource adiq>ter 202 
im p l p»nm*ati mi .q ijn ’M ii t s reauthenticalion of earisting ManapedCpunection instanca Note 
that tins infonnatirm is for the resource adapter 202 inyle m en t a tio n and not for the 
20 muia ^ym g BIS instance. This element is one of file following: 

<teautiieaticatiorisiq>pc«t>1rne</reanthenticationsiqport> 



> 

clELEMENT reanthenticatioDSiq>port (#PCDATAX> 

25 <! 

The element qiecveision ^>eafies file version of file connector andntectnre 
q>eQfication that is supported by fins resource adapter 202. This rnfonnation enables 
deployer to configare file resource adj»p tftr 202 to support d^Ioynunt and luntime 
requirements of fiie corresponding connector spedficationL 

30 Exainple: 

<q)ecvHsion>1.0</qpecvemiori;> 

> 
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<!ELEMENT specvotsion (#PCDATA)> 

<! 

The eleEneDt securitypemiission spedfies a security permission that is reqniTed by 
the resource aispta code. The security permission listed in die dqiloymeot desoiptor are 
5 ones that are different from those required by the defruilt permission set as qiecified in die 
comiector qiecification. The optional desoiption can mention specific reason that resource 
ad^to^ 202 requires a given security permission. 

> 

<!EIJ2MENT securitypennission (description?, securitypamisdonspec)> 

10 <! 

The element secnritypermissimr^iec qiecifies a security permission based on the 
Security policy file syntax. 

Example: httpyi9ava.sun.com^m)dDcts^dk/1.2/docs/guidG/security^oli<^ilesJitm]# 
FileSyntax 
15 > 

<!ELEMENT secnritypeimissioDspec (#PCDATA)> 

<! 

The transactionsiqipoit element ^ledfies the level of transaction siqiport provided 
by die resource adrqiter. Thevaloeoftransactionsiqipoitisoneofdiefiillowiiig: 

20 <transactionsuppoit>nojbransaction</lransactionsiq>port> 
<transactionsiq>poit>localjbmisactionr</ttansacti<msiq>poc> 
<transactionsiq>port>xajl]nri8actioii</transactioiisiqiport> 

> 

<1ELEMENT transactionsupport (#PCDATA)>.<! 

25 The elmnentvoadomameqiedfies die name of connects provider vendor. 

Bxanqile: > 

<veiidomame> Wombat Corp.<A'eaidoniame> 

> 

<1ELEMENT vendomame (#PCDATA)> 

30 <1 
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The elCTient msion q>ecifies a string based vCTsion of tibe resource adq>ter 202 
fit)m the connector provider. 

Example: 

<vCTsion>l ,0</vrasion?» 

5 > 

<!ELEMENT version (#PCDATA)> 

<1 

The ID allows tools tiiat produce additional deployment information 

(beyond the standard dq>loymeot desaiptor) to store the nonstandard infonnation in a 
10 sq>arate file and to refer to standard dqjloyment descr^tor firom these nonstandard took 
specific file. Tools cannot add the nonstandard infonnation into the standard dqploymoit 
descriptor. 

> 

<1 ATTLIST authmechanism id ID #IMPLIED> 

15 <vaTTT .TST anflnnechtype id ID #IMPLIED> 

<! ATTLIST configpreqperty id ID #IMPLIED> 

<! ATTLIST config>n^)eityname id ID #IMPL1HD> 

<! ATTLIST confi gproper t y vahie id ID #IMPLIED> 

<! ATTLIST config)ropertytype id ID #IMPL1KD> 

20 <! ATTLISr connector id ID #IMPLIE[^ 

<! ATTLIST connectionfoctoryinterfoce id ID #IMPL1KI» 

<! ATTLIST connectionfiictoiyimplclass id ID #IMPLlHi» 

<! ATTLIST coonectioninterfoce id ID #IMPLJED> 

. <1 ATTLIST connectioniiiq)lclass id ID #IMPIitiD> 

25 <1 ATTLIST aedenfialmteifiice id ID #IMPLIED> 

<!AT1UST description id ID #IMFUED> 

<! ATTLIST diq>Iayname id ID iSMPLlED> 
clATTLIST eistype idID #1MPLIED> 

<!ATTLIST icon id ID #EMKIED> 

30 <f ATTLIST managedcomtectionfoctoiyclass id ID #IMPL1ED> 
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<! ATTUST reaothenticationsuppoit id ID #IMPO0D> 

<! ATTUST resourcead^ter id ID #IMPLIBD> 

<! ATTUST securitypennission id ID #IMPLIED> 

<! ATTUST securitypraniissionq)ec id ID #IMPLIED> 

5 <! ATTLIST specvasion id ID #IMPLIED> 

<! ATTUST transacdonsi^>port id ID #IMPUED> 

<! ATTUST vmdomame id ID #IMPL1ED> 

WTiil« a ^stem fi>r a modolar and portable dgiloyment of a resource ad^>ter m a 
clioit saver computer environment bas been desoibed and ilhistrated in detail. While diete 
10 have bem described above the principles ofttiepresoitiiivailion in cmgunction with 

various enobodiments, dre foregoing description is made only by way of example and not as 
a limitation to die scope of the invaidon. 
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(XAIMS 

What is claimed is: 

1. A r j>mp pter system having a client server architecture, comprising: 

5 an application saver; 

an enterprise information system induding computing resources; 
a connection provider; 

a resource adapter, said resource adr^ter implemented by said connection provida 
to serve said resources from said entearprise information system to climts, whodn flie 
10 yith a dgiloynient descriptor to ioiinaresoutceadaptCT' 

module coneqKmding to a J2EE module hierardiy, wherein said resource adapter module is 
dqiloyed into the i^lication saver to allow multq>le J2EB plications to share die 
resource adiqiter module; and 

ad^loyer, said d^loyer using a d^loyment tool to configure die resource adapter 
15 into a target operadonal environment, the dqiloyment tool cspable of reading die 
dqployoient deso^tor. 

2. The conqinter system of C3aim 1, wherein die resource adapter module pdfies a 
level of transaction support provided by die resource ad^ter. 

20 

3. The computer system of Claim 2, -wdiereia die levd of transaction soiport indicates 
no transaction snpporL - 



4. The cOTcputer^stem of Churn 2, wherdnd» level oftransaction sport indicates 
25 local transaction support 

5. Iheconpter system ofdaim 2, wherein the level oftransaction sport indicates 
resource managa local transactions are supported. 

30 6. The ctmpter system of Claim 5, wherein local resource noanagertransactirais are 

supported by inqilanenting a LocanVaosaction inter&ce. 
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7. The computer system of Claim 2, wherein Ae level of transaction siqjport indicates 

JTA transactions ate siqipotted. 



8. The compute: system of Qaim 7, whraein JTA transactions are supported by 
S implementing an XAResoutce intei&ce. 

9. The compute systenofClaim 2, vherdn the dq>k>yar configures die q>pUcation 
server for transaction management based on the level of transaction support ^ecified by die 
resource adapter. 

10 

10. The compute system of Claim 1, wherein the connection provi^^ qiecifies name, 
type, and desmiption for prop aties that have to be configured on a per connecdon foctory 
instance basis; wherein the properties detemine connections to a sped£c entepiise 
information system instance. 

15 

11. The compute systen of Claim 10, 'Mierdn die connecdon fitctCHty instance is 
roistered in a namespace. 

12. The conopute system of Claim 1, wherein the connecdon provider specifies 
20 authenti cation me c h a ni s ms that are s i p p o rted by die resource ad^ite. 

13. The conpnte^stemofClaiml, wherein die dqiloyer configures the qjplicadon 
serva for transacdon sippOTt based on die level of supp^ qiedfied by the resource 
adapter. 

25 

14. The compute tystem of Claim l,wheimn die connecdon provider q;>ecifieswhedier 
the resource adrpte sipports leauthendcadm of an existing physical connecdon. 

15. The conpute system of Claim 1, wherein die dqiloyment tool is provided by die 
30 qplicadon server. 
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16. The computer systen of Claim 1, wherein the d^loyment descriptor defines a 

contract between the connector provider and die deploy er. 



17. A computer program product; which, when executed by a computer, implements a 

5 cliart server computer system by performing the stqis of: 

providing an qiplication servo; 

providing an mteiprise information system mctuding computing resources; 
providing a connection provider; 

providing a resource ad^ter, said resource adapter irrplonented by said ooimection 

10 provider to serve said resources fiom said entequise information system to clients, wherein 

die resource is packaged with a dq;>loyment descriptor to form a resource adapter 

module cmre^nding to a J2EB module hieraidiy , udierein said resource ad^ter module is 
dqiloyed into die applicaticm server to allow multiple JZEBqjpIications to share the 
resource adapter module; and 

15 providing a dqiloyer, said deployer nring a deployment tool to configure the 

resource adapter into a target opemtional environment, the dqiloyment tool c^iable of 
reading the dq;>loyment descriptor. 
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